home *** CD-ROM | disk | FTP | other *** search
/ The Programmer Disk / The Programmer Disk (Microforum).iso / xpro / c / pro16 / wn_guint.c < prev    next >
C/C++ Source or Header  |  1990-03-23  |  7KB  |  157 lines
  1. /*
  2. ** The Window BOSS's Data Clerk
  3. ** Copyright (c) 1988 - Philip A. Mongelluzzo
  4. ** All rights reserved.
  5. **
  6. ** wn_guint - get unsigned integer from window with validation 
  7. **
  8. ** Copyright (c) 1988 - Philip A. Mongelluzzo
  9. ** All rights reserved.
  10. **
  11. */
  12.  
  13. #include "windows.h"                    /* standard stuff */
  14.  
  15. /*
  16. ************
  17. * wn_guint *
  18. ************
  19. */
  20.  
  21. /*
  22. ** wn_guint(fun,frm,fld,wn,row,col,prmpt,atrib,fill,v,fwidth,low,high,ubuff,hlpmsg,errmsg)
  23. **
  24. **    int        fun - fucntion code (SET || XEQ)
  25. **    (WIFORM)   frm - form pointer  (actual || NFRM)
  26. **    int        fld - field # in form (actual || NFLD)
  27. **    (WINDOWPTR)wn  - window pointer
  28. **    int        row - row in window where data input begins
  29. **    int        col - col in window where data input begins
  30. **    (char *) prmpt - field promt (call with NSTR for none)
  31. **    unsigned atrib - field (not prompt) atributes 
  32. **    char      fill - field fill character
  33. **    (unsigned *) v - pointer to int for return value (low-high)
  34. **    int     fwidth - width of mask (maximum # of digits is 6 with sign)
  35. **    unsigned   low - minimum value (lower limit of value)
  36. **    unsigned  high - maximum value (upper limit of value)
  37. **    (char *) ubuff - pointer to char array of 10 bytes for editing 
  38. **    (char *)hlpmsg - pointer to help message (call with NSTR for none)
  39. **    (char *)errmsg - pointer to err message (call with NSTR) for none)
  40. **
  41. ** RETURNS:
  42. **
  43. **    V via pointer.
  44. **
  45. **    NULL if error, else the non zero value returned from wn_input.
  46. **
  47. ** NOTES:
  48. **
  49. **  FUN -   fun can only be SET for form setup, or XEQ for immediate
  50. **          execution.  When called with SET, valid arguements for both
  51. **          "frm" and "fld" must be specfied.  frm is the field pointer
  52. **          returned from frmopn(), and fld is the field sequence number
  53. **          in the form for this field.  When called with XEQ frm must
  54. **          be NFRM and fld must NFLD.
  55. **
  56. **  UBUFF - Editing buffer.  Must be of sufficent size to hold the
  57. **          data as it is entered.  Typical value is the length
  58. **          of the mask + 2 bytes (strlen(mask)+2).
  59. **
  60. **          On entry, the first byte of ubuff should be 
  61. **          a null, otherwise wn_input assumes there is valid
  62. **          data there and will enter edit mode.  This can be 
  63. **          handy if there is a need for prefilled but editable
  64. **          fields.  In actual pratice, wn_input uses this
  65. **          buffer for both initial character data entry and
  66. **          subsequent editing.
  67. **
  68. **          On return, ubuff contains the actual data entered in
  69. **          character format with fill and mask characters as
  70. **          spaces (e.g. "-24000").
  71. **
  72. **  Calls wn_input to perform data entry.
  73. **
  74. **  Data must satisfy validation checks for function to return.
  75. **
  76. **  Calls wn_iemsg(errmsg) when vaildation fails.
  77. */
  78.  
  79. /*
  80. ************
  81. * wn_guint *
  82. ************
  83. */
  84.  
  85. wn_guint(fun,frm,fld,wn,row,col,prmpt,atrib,fill,value,fwidth,low,high,ubuff,hlpmsg,errmsg)
  86. int fun;                                /* SET or XEQ */
  87. WIFORM frm;                             /* form pointer or NFRM */
  88. int fld;                                /* field number or NFLD */
  89. WINDOWPTR wn;                           /* window to use */
  90. int row, col;                           /* position of input field */
  91. char *prmpt;                            /* prompt string */
  92. unsigned atrib;                         /* data entry atribute */
  93. char fill;                              /* fill char */
  94. unsigned int *value, low, high;         /* the int, limits: low & high */
  95. int fwidth;                             /* field width */
  96. char *ubuff;                            /* returns "value" */
  97. char *hlpmsg, *errmsg;                  /* help & error messages */
  98. {
  99. unsigned int v;                         /* temp value */
  100. long lv;                                /* ditto */
  101. char mask[10];                          /* single precision */
  102. unsigned int r;                         /* sscanf return value */
  103. int rv;                                 /* return value */
  104.  
  105.   if(fun != SET && fun != XEQ)          /* saftey check */
  106.     return(NULL);
  107.  
  108.   if(fun == SET) {                      /* set up */
  109.     if(frm[fld]->pself != (char *)frm[fld])
  110.       wns_ierr("wn_guint");             /* die if memory is mangled */
  111.     frm[fld]->wn = wn;                  /* set window */
  112.     frm[fld]->row = row;                /* set row */
  113.     frm[fld]->col = col;                /* set col */
  114.     frm[fld]->prmpt = prmpt;            /* set prompt */
  115.     frm[fld]->atrib = atrib;            /* set attribute */
  116.     frm[fld]->fill = fill;              /* set fill character */
  117.     frm[fld]->fcode = GUINT;            /* function code */
  118.     frm[fld]->v1.vuip = value;          /* &value */
  119.     frm[fld]->v2.vui = fwidth;          /* fwidth */
  120.     frm[fld]->v3.vui = low;             /* lower limit */
  121.     frm[fld]->v4.vui = high;            /* upper limit */
  122.     frm[fld]->v5.vcp = ubuff;           /* &ubuff */
  123.     frm[fld]->v6.vcp = hlpmsg;          /* &hlpmsg */
  124.     frm[fld]->v7.vcp = errmsg;          /* &errmsg */
  125.     return(TRUE);
  126.   }
  127.  
  128.   strcpy(mask,"#######");               /* set mask */
  129.   if(fwidth > 6) {                      /* dont allow foolishness */
  130.     *ubuff = NUL;                       /* indicate error */
  131.     return(NULL);                       /* and return */
  132.   }
  133.   mask[fwidth] = NUL;                   /* set length */
  134. begin:
  135.   if(!(rv=wn_input(wn,row,col,prmpt,mask,fill,atrib,ubuff,hlpmsg))) {
  136.     *ubuff = NUL;                       /* indicate error */
  137.     return(NULL);                       /* indicate error */
  138.   }
  139.   if(wni_frmflg) return(TRUE);          /* wn_frmget in progress */
  140.   if(wns_escape) return(rv);            /* escape pressed ?? */
  141.   r = sscanf(ubuff, "%ld", &lv);        /* convert to long */
  142.   if(r == EOF || r == 0) lv = 0l;       /* no data */
  143.   if(lv < 0 || lv > 65535) {            /* range check data type */
  144.     wn_iemsg(errmsg);                   /* do error message */
  145.     goto begin;                         /* and start over */
  146.   }
  147.   v = (unsigned int)lv;                 /* convert to unsigned int */
  148.   if(v < low || v > high) {             /* bad int */
  149.     wn_iemsg(errmsg);                   /* do error message */
  150.     goto begin;                         /* and start over */
  151.   }
  152.   *value = v;                           /* load user value */
  153.   return(rv);                           /* all is well.. in gross sense */
  154. }
  155.  
  156. /* End */
  157.